home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / packages / babel / install.txt < prev    next >
Text File  |  1995-03-15  |  5KB  |  90 lines
  1.                            Babel Installation Guide
  2.  
  3.                                   3 July 1994
  4.  
  5.  
  6.         When you install the babel system you have first to decide
  7.         whether you want to make a new format file. If you don't, you
  8.         miss some of the functionality of the babel system, but you
  9.         can then skip steps 2 through 6 . If you do want to build a
  10.         new format, start with step 1.
  11.  
  12.         When you want to produce the full listing of all the source
  13.         files in the babel system run babel.drv through LaTeX, then
  14.         use MakeIndex to produce babel.ind using bbind.ist as a style
  15.         file and use MakeIndex to produce babel.glo using bbglo.ist as
  16.         a style file. Then run LaTeX on babel.drv again.
  17.  
  18.         When you want to use the babel system with plain TeX you will
  19.         have to produce slightly different stripped files. Add the
  20.         `compat' option to each line in the file babel.ins.
  21.  
  22.         1 Make sure that you have the Docstrip (version 2) program
  23.           available (it is part of the LaTeX2e distribution);  then
  24.           run the file babel.ins through TeX. 
  25.           This strips all the .dtx files of the comments and produces
  26.           fast loadable versions of the files. It will tell that you
  27.           have to move the resulting .sty and .def files into a
  28.           directory where TeX can find them.
  29.           Do that now.
  30.  
  31.           Docstrip also produces two files called babel.drv and
  32.           user.drv. You can use babel.drv to produce the full
  33.           documented source listing of the babel system. (Which is
  34.           also provided as babel.dvi) You can use user.drv to produce
  35.           a short document that describes the features of each
  36.           language specific file.
  37.  
  38.         2 Make sure you have the hyphenation patterns available for
  39.           the languages that you intend to use. If you don't have
  40.           them, you may be able to find them in CTAN, in the directory:
  41.           /tex-archive/language/hyphenation.
  42.           If you happen to have a set of patterns that is not
  43.           available there you could make it available b yeither
  44.           putting it in the /incoming directory or sending it to me.
  45.  
  46.         3 Make sure that the iniTeX you are using has a sufficiently
  47.           large trie_size and trie_op_size to be able to process all
  48.           the hyphenation patterns that you wish to load into your
  49.           format. If you can recompile TeX, do so (with enlarged
  50.           parameters) if you need more than one or two languages.
  51.  
  52.         4 The docstripping process will have produced a file called
  53.           lthyphen.cfg. This file will be loaded when you build a
  54.           LaTeX format. To build a plain format with the babel system
  55.           preloaded you should make sure that the standard file
  56.           `hyphen.tex' has a different name. You could for instance
  57.           rename it to UShyphen.tex, to indicate American English
  58.           hyphenation patterns.
  59.  
  60.         5 Check the hyphenation patterns that you have available and
  61.           want to load into the format. For each language that you
  62.           want to hyphenate correctly you need a hyphenation pattern.
  63.           List them all in the file `language.dat'. The file that is
  64.           in the distribution serves as an example of what you have to
  65.           put in there.
  66.           **NOTE The file language.dat that is in the distribution
  67.           ** loads hyphen.tex for english. When you want to use babel
  68.           ** with plain TeX you will have to rename the file
  69.           ** hyphen.tex and therefore you will have to change
  70.           ** language.dat to reflect that change.
  71.  
  72.         6 Run iniTeX, telling it to load your favorite macro package
  73.           (ie plain or latex).
  74.           When you build a LaTeX format iniTeX will find the file
  75.           lthyphen.cfg (provided that you have stored it in the
  76.           correct place).
  77.           When you build a plain TeX format iniTeX tries to find
  78.           hyphen.tex. If you have renamed or moved that file iniTeX
  79.           will tell you that the file can't be found and ask you for a
  80.           different name. Enter `lthyphen.cfg' at this point.
  81.           If you haven't renamed of move hyphen.tex the format will be
  82.           built *without* the babel code.
  83.  
  84.           *Beware*: some implementations of TeX only look in the
  85.           current directory when the \openin primitive is used. If
  86.           your TeX does that you need to put the file `languages.dat'
  87.           in the same directory where you build your format.
  88.  
  89.  
  90. --- Copyright 1994 Johannes Braams.  All rights reserved ---